home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / ab20_archive / games / strategy / empire-2.2w.lzh / Doc / EmpCre < prev    next >
Text File  |  1990-08-25  |  15KB  |  270 lines

  1.             Amiga Empire by Chris Gray - Using EmpCre
  2.  
  3.  
  4. EmpCre is the program which creates new worlds for use with Empire. It
  5. gives some flexibility in the general characteristics of the world
  6. generated, but it does not allow for the modification of the many
  7. parameters that are used during Empire play. Those parameters can be
  8. modified by a deity using Empire itself.
  9.  
  10. When EmpCre is run, it checks to see if it's standard input is interactive
  11. or not. If it is not, it is assumed to be a script file containing correct
  12. values, one per line, for the parameters it requires. Invalid or illegal
  13. values will illicit an error message and EmpCre will abort. If it is
  14. running interactively, EmpCre prompts for each required value and will loop,
  15. requesting new values, until a valid one is entered. The prompt for the
  16. values will contain a brief description, the maximum and minimum values,
  17. and the default value, which will be used if you just hit RETURN.
  18.  
  19. The algorithm used by EmpCre to create the terrain is a variant of my
  20. terrain generator, which appeared on Fish Disk #61. As a result, the size
  21. of the world must be a power of two and the world must be square. The
  22. various 'Range' values are set to produce interesting worlds, but they can
  23. be modified in the source if desired. Once the terrain has been created,
  24. the next step is to add gold and iron deposits to the world. This is done
  25. by using yet another variant of the same algorithm, this time tuned to
  26. produce very small clusters of deposits, with half of the allocated
  27. deposits spread randomly, just for good measure. The parameters associated
  28. with these activities are:
  29.  
  30.     Power of two size of world - this must be one of 4, 5, 6, 7 or 8 to
  31.         specify a world size of 16 x 16, 32 x 32, 64 x 64, 128 x 128 or 256
  32.         x 256. A. 16 x 16 world is generally big enough for two players,
  33.         and is a quick way for two beginners to get into the game. A 32 x
  34.         32 world is the most likely to be appropriate. It can be used for 3
  35.         to 6 players (you are unlikely to be able to place 7 sanctuaries on
  36.         a 32 x 32 world, but if you change some of the later parameters, it
  37.         may be possible). A 64 x 64 world is good for at least 15 players
  38.         and possibly for up to 17 or more, depending on how persistent you
  39.         are in running EmpCre. 128 x 128 and 256 x 256 worlds are big
  40.         enough for the maximum number of player countries, which is 44. The
  41.         default world size is 32 x 32 (a value of 5 for this parameter).
  42.  
  43.     Percent mountain - this is the percent of the sectors in the world that
  44.         should be mountain sectors. Allowed values are from 0 to 75, with a
  45.         default of 5 percent. Smaller values can result in dull worlds,
  46.         larger values could prevent successful sanctuary placement, unless
  47.         you have a small number of countries in a large world.
  48.  
  49.     Percent wilderness - this is the percent of the sectors in the world
  50.         that should be wilderness sectors. All sectors that aren't mountain
  51.         or wilderness will be water. Using a larger value here would result
  52.         in a smaller proportion of water, perhaps allowing more sanctuaries
  53.         to be placed in a smaller world. A smaller value in a small world
  54.         could be used to make the game more naval. Allowed values are from
  55.         5 to 99 - [percent mountain] with a default of 38 percent.
  56.  
  57.     Percent x 10 good iron - this tells EmpCre what proportion of rich iron
  58.         deposits you want. It is scaled by 10 to provide more accuracy.
  59.         Values range from 0 to 100 with a default of 5. Note that the amount
  60.         of iron ore available in the world has a significant affect on the
  61.         play of the game. An iron-poor world will have little production,
  62.         poor technology and few ships. Wars can be fought over a few good
  63.         iron mines. Over-abundant iron deposits can result in explosive
  64.         growth (provided the funds are available), hundreds of ships and a
  65.         very high technology level. This parameter interacts closely with
  66.         the levels chosen for iron ore deposits.
  67.  
  68.     Percent x 10 good gold - this parameter is completely analagous to the
  69.         previous one, except that it controls the proportion of gold ore
  70.         deposits instead of iron ore deposits. In a gold poor world, banks
  71.         will be critical targets, and growth can be curtailed. In a gold
  72.         rich world, money soon becomes irrelevant (which may be precisely
  73.         what you want).
  74.  
  75. After the terrain is created, EmpCre attempts to place the required number
  76. of sanctuaries. There are several heuristics used in trying to come up with
  77. a good sanctuary placement. The overall goal is to avoid situations in
  78. which one country is at a disadvantage due to starting up later than some
  79. neighbor, or simply due to which sanctuary he/she gets. Also, since the
  80. person who runs EmpCre may want to play in the game, it should not be
  81. necessary for anyone to check over the world for reasonableness. The
  82. parameters requested are:
  83.  
  84.     Maximum number of countries (including deity) - this is the number of
  85.         countries that are allowed in the game. Country #0 is always
  86.         reserved as a deity. All countries except the first will be given
  87.         sanctuaries placed on the world according to the heuristics
  88.         described here. The default value presented will depend on the size
  89.         of the world being built.
  90.  
  91.     Minimum sanctuary spacing - this is the minimum distance that must
  92.         separate any pair of sanctuaries if the placement is to be valid.
  93.         It is allowed to be from 3 to 100, but the default of 10 is
  94.         probably close to optimal.
  95.  
  96.     Minimum wilderness adjacent to sanctuary - this value specifies how
  97.         many wildernesses must be directly adjacent (orthogonally or
  98.         diagonally) to either of the two sanctuaries before the placement
  99.         will be accepted. The intent here is that sanctuaries that are
  100.         stuck out on a peninsula are at somewhat of a disadvantage. The
  101.         range is from 0 to 10 with a default of 4. A value of 10 would
  102.         force all sanctuaries to be inland and not beside any mountains,
  103.         but might take a number of EmpCre runs to satisfy.
  104.  
  105.     Minimum unclaimed reachable sectors - as part of the world generation
  106.         process, EmpCre "allocates" wildernesses to each of the sanctuaries
  107.         that it is trying to place. There must be at least this many
  108.         available to each sanctuary in order for the placement to be
  109.         accepted. The range is from the chosen value for the previous
  110.         parameter up to 200, with a default of 40.
  111.  
  112.     Maximum distance for those sectors - this is the maximum range that the
  113.         above count of wildernesses can be from the sanctuaries. Allowing
  114.         too large a value can result in sanctuaries whose accessible
  115.         sectors are a long way away, often connected only by a thin, very
  116.         vulnerable strip. Specifying too small a value can result in an
  117.         impossible placement (i.e. if a circle that size doesn't have
  118.         enough sectors to satisfy the previous requirement), or can result
  119.         in placements that are uninteresting (everybody is in the middle of
  120.         large open regions). Allowed values are from 4 to 100, with a
  121.         default value of 15.
  122.  
  123.     Maximum spread of rich iron counts - when EmpCre is counting the number
  124.         of unclaimed wildernesses "associated" with each sanctuary, it also
  125.         counts the number of rich iron and gold deposits in those sets.
  126.         This parameter controls the maximum difference in those counts that
  127.         is allowed between different sanctuaries. Again, this is an attempt
  128.         at "fairness". If you allow this count to be large, you can produce
  129.         a world in which some countries MUST attack their neighbors in
  130.         order to find adequate resources. This is not recommended for
  131.         beginning players. Values can range from 0 to 1000 (infinity) with
  132.         a default of 4.
  133.  
  134.     Maximum spread of rich gold counts - this is entirely analagous to the
  135.         previous parameter, but controls the range of gold deposit counts
  136.         instead of iron deposit counts.
  137.  
  138. Once the physical arrangement of the world is determined, EmpCre must chose
  139. gold and mineral deposits for each of the wilderness sectors. Each sector
  140. can be either rich or poor in terms of iron ore deposits and either rich or
  141. poor in terms of gold ore deposits. Each classification uses a two-part
  142. calculation to determine the deposit. First, a random value in a
  143. parameterized range is generated, and then a fixed value is added to it. If
  144. the random range is 1, then all deposits will be the same, as determined by
  145. the fixed value. If the fixed value is 0, then the deposits will be
  146. completely random within the random range specified. Some middle ground is
  147. probably more reasonable. The values required are:
  148.  
  149.     Base level for good iron - this is the fixed part for iron ore deposits
  150.         in sectors which are intended to be rich in iron. It can be from 0
  151.         to 127 and defaults to 32.
  152.  
  153.     Maximum random addition for good iron - this is the range of the random
  154.         value which is added to the above base value. It can be from 1 to
  155.         128 and defaults to 96. Note that it is possible to have deposits
  156.         over 127, even though that is "nonstandard".
  157.  
  158.     Base level for normal iron - this is the fixed part for iron ore
  159.         deposits which are not intended to be rich in iron. It can be from
  160.         0 to 127 and defaults to 0.
  161.  
  162.     Maximum random addition for normal iron - this is the range of the
  163.         random value which is added to the above base value. It can be from
  164.         1 to 128 and defaults to 96. With all default values, good iron
  165.         will range from 32 to 127 and normal iron will range from 0 to 95.
  166.         If you want to have a more significant difference between good
  167.         deposits and normal deposits, it is advisable to also have a
  168.         smaller value for "Maximum spread for rich iron counts" so as to
  169.         keep the game reasonably fair.
  170.  
  171.     Base level for good gold
  172.     Maximum random addition for good gold
  173.     Base level for normal gold
  174.     Maximum random addition for normal gold
  175.         these values are for gold deposits as the previous four are for
  176.         iron deposits.
  177.  
  178. Once the above data is entered, there remain only six values that must be
  179. entered:
  180.  
  181.     Maximum connect time per day in minutes - this is the maximum time
  182.         that each country will be allowed to play Empire each day. It is
  183.         displayed in the Empire prompt. Accepted values are from 1 upto
  184.         1440 (24 hours) with a default of 60 (one hour). If you only have
  185.         one serial port for external connections, you will want to keep
  186.         this value low, so that all of the players have a chance to use up
  187.         their time. If you are playing a "quick" game, you may want to use
  188.         1440. Each country will be initialized to have this much connect
  189.         time.
  190.  
  191.     Seconds per ETU - this value effects how fast things happen in Empire.
  192.         The default value of 1800 means that an Empire Time Unit is a half
  193.         hour. A game run at this rate will normally last 2 - 4 months.
  194.         {at least -d.w.} Each player will normally use 10 - 60 minutes a
  195.         day. Using a larger value is of dubious value. Smaller values make
  196.         the game go much faster, but also require more timer per day from
  197.         the players.
  198.         During testing, we have found that a value of 20 seconds makes for
  199.         a very interesting game that can be over in less than 24 hours of
  200.         play. This turns Empire from a few month game to a weekend game.
  201.         To do this, all players need to be connected at once, so unless you
  202.         are playing only two players, you will need additional serial ports
  203.         and modems connected to your Amiga. If you set this value too
  204.         small, the players will not be able to type commands fast enough to
  205.         keep up with demand, and a straight 68000 may not be able to
  206.         compute fast enough to keep things updated.
  207.  
  208.     Initial amount of money per country - this is the amount of money that
  209.         each country will have in the bank at the start of the game. Making
  210.         this value too small will simply frustrate the players. Making it
  211.         too large will delay the point where money becomes important (if it
  212.         ever does - see the above discussion of gold deposits).
  213.  
  214.     Winner of the last game - This is the person, alliance, etc. who won
  215.         the previous game.
  216.  
  217.     Allow public messages - This boolean value determines whether regular
  218.         countries can send public messages. Depending on your disk space,
  219.         you may not want to allow general public messages. The deity can
  220.         still send telegrams to *, but no other countries can.
  221.  
  222.     Allow changing countries - Setting this to false will not allow people
  223.         to use the "change country" option. You may want to prevent this
  224.         changing as it can tie up the line for quite a while without giving
  225.         other countries a chance to call in.
  226.  
  227. After the initial terrain and deposit setup has been created, EmpCre will
  228. ask if you want to have the resulting terrain displayed. If you answer yes,
  229. then a map will be shown. On this map, water, wilderness, mountain and
  230. sanctuary sectors are shown as normal. Sectors shown as 'I' have good iron
  231. deposits; sectors shown as 'G' have good gold deposits; and sectors shown
  232. as 'X' have both good iron and good gold deposits.
  233.  
  234. After a successful world build, EmpCre will ask if you want to write the
  235. world data files. Be careful not to answer incorrectly here. If you answer
  236. yes, then the various Empire data files are destroyed, then recreated with
  237. the new world in them. If you answer no, the just-created world is
  238. discarded and EmpCre exits. If the world files are to be written, EmpCre
  239. will ask for two needed passwords:
  240.  
  241.     Enter god password - this password is the initial password for the
  242.         Deity - try not to forget it. The script files specify a god
  243.         password of 'godpassword'.
  244.  
  245.     Enter creation password - this password will be needed once by each
  246.         player in order that they be allowed to create a new country. After
  247.         all countries have started up, you can safely forget it. The script
  248.         files specify a creation password of 'creationpassword'.
  249.  
  250. When EmpCre is run from a shell, it can be given the parameter '-a', which
  251. tells it not to try to blank the passwords when they are asked for. This is
  252. useful if EmpCre is being run from other than a standard console window,
  253. and the control sequences used for the blanking do not work.
  254.  
  255. When run from WorkBench, the Tool Type 'PATH=' can be given. This tells
  256. EmpCre where to create the data files. It should be a path name ending in a
  257. ':' or a '/'. If the specified directory contains a file called
  258. 'empire.files', then the various files can be created in multiple
  259. directories and on multiple drives. See the 'Hosting' document for
  260. more details on this.
  261.  
  262. NOTE: If you are creating a world in the same directory as a previous
  263. world, you MUST delete the old news and propaganda files yourself. The best
  264. way to do this is to type:
  265.         delete news.#?
  266.         delete prop.#?
  267. If you fail to do this you may get news articles that are nonsensical, or
  268. that cause great confusion.
  269.  
  270.